home *** CD-ROM | disk | FTP | other *** search
/ Compendium Deluxe 1 / LSD Compendium Deluxe 1.iso / a / intuition / menu / menumaker.lha / Menu-Maker.doc < prev    next >
Encoding:
Text File  |  1991-05-10  |  13.7 KB  |  301 lines
  1.  *****************************************************************************
  2.  *                                                                           *
  3.  *                      BOOT-MENU WRITER 1.0 Instructions                    *
  4.  *                      ---------------------------------                    *
  5.  *                          Release Date : 20.03.1991                        *
  6.  *                                                                           *
  7.  *                       (C) By DOCTOR PSI / ZENITH 1991                     *
  8.  *                                                                           *
  9.  *****************************************************************************
  10.  
  11.                        This program is fully PUBLIC DOMAIN
  12.                           'Spread the word and the disk'
  13.  
  14.     PLEASE !!! Read the doc carefully before using this powerful utility !
  15.  
  16.  
  17.  1. Introduction
  18.  -----------------------------------------------------------------------------
  19.  
  20.  First I coded this utility for my own use because I needed a program to do my
  21.  demos and utilities packs and this easily and very quickly. Some friends told
  22.  me that this program is great and that I should improve it and then spread
  23.  it... Boot-Menu Writer 1.0 was born !!!
  24.  
  25.  I used the wellknown 'bootblock+loader' method and I modify it a little bit :
  26.  the BootBlock-Menu is loaded (fast) : you choose the prg/demo you want and
  27.  press the corresponding key to load it. Then the normal process go on with
  28.  the startup-sequence : the loader load the file 'FILES' (which contains the
  29.  Filenames and the Keys), search the choosen file, load and run it. I think
  30.  it is the best and fastest way ! I HATE those packs where you've to wait
  31.  while loading and decrunching, then choose your file with the mouse, and
  32.  which use lot of disk space ! Arghhh !!!
  33.  
  34.  With this utility you can :
  35.  
  36.  - Install a nice Bootblock-Menu with 628 bytes only for the text !!! You can
  37.    modify everything by yourself (colors, texts,...). You can also use this
  38.    BootBlock to write a message !
  39.  
  40.  - Write the Loader and the needed files (Run, StartUp-Sequence,...)
  41.  
  42.  - Edit a Files List (which contains the files you want to load) : just click
  43.    a file in the directory and press the corresponding keys to load it. And
  44.    you can keep the filenames like they are ! (don't need to rename them like
  45.    '1', '2',...) It's so easy !
  46.  
  47.  
  48.  2. Instructions
  49.  -----------------------------------------------------------------------------
  50.  
  51.  The screen is divided in 4 parts: - left window : Commands / Options
  52.                                    - right window : Directory / List
  53.                                    - 3rd window : Colors Palette
  54.                                    - the BootBlock-Menu (lower part)
  55.  
  56.  Remember : you must know what you are doing when you use a command/option !!!
  57.             So read the following text carefully...
  58.  
  59.  
  60.  2.1 Commands / Options window (left one)
  61.  -----------------------------------------------------------------------------
  62.  
  63.  - STATUS LINE      Show you what the program is currently doing (Msgs) and
  64.                     the possible errors. So watch out !
  65.  
  66.  [ READ BBM ]       Read a BootBlock-Menu from the selected drive (DF0-DF3).
  67.  
  68.  [ WRITE BBM ]      Write the current BootBlock-Menu to the selected drive
  69.                     (DF0-DF3).
  70.  
  71.  [ DF0-DF3 ]        Change the drive from DF0 up to DF3 (if available). This
  72.                     option only affects the READ & WRITE BBM commands. Very
  73.                     usefull if you want to use an old BBM (because you like
  74.                     its colors for example...).
  75.  
  76.  [ DF0: ]           Get the directory of the Workdisk (in drive DF0).
  77.  
  78.  [ PARENT ]         Get the previous directory from the Workdisk.
  79.  
  80.  [ WRITE LOADER ]   Write the Loader to the Workdisk. It also write the 'Run'
  81.                     command (in the C/ dir if available) and even the
  82.                     'StartUp-Sequence' (create the S/ dir if not available !).
  83.  
  84.  [ FILES IN BBM ]   A very cool option (for lazy typers...). It insert the
  85.                     current Files List (max. 20 entries) in the BBM : the
  86.                     Keys and the Filenames are copied in the BootBlock-Menu !
  87.                     If the Files List is empty, the BBM will be cleared
  88.                     (except the title).
  89.                     
  90.  [ LOAD FILES ]     Load the Files List ('DF0:Files') from the Workdisk. 
  91.  
  92.  [ SAVE FILES ]     Save the current Files List to the Workdisk.
  93.  
  94.  [ CLEAR FILES ]    Clear the current Files List (in the prg !). Usefull when
  95.                     you start a new Files List for a new pack...
  96.  
  97.  - SELECTED FILE LINE   Show you the current Selected File from the Directory
  98.                         or the Files List (depend in which mode you are).
  99.  
  100.  [ INSERT FILE ]    Insert the current Selected File from the Directory
  101.                     in the Files List : the whole path is copied, so you can
  102.                     load ALL the files (in any dir) from your Workdisk !
  103.                     Note that you have max. 4096 bytes for the Files List.
  104.                     You have also to enter the Key that will load this file :
  105.                     you can use the WHOLE keyboard (except the Caps Lock).
  106.                     Anyway, the keyboard is the USA one (sorry...). If you
  107.                     have another keyboard, then correct the Keys in the BBM
  108.                     texts (if you used the FILES IN BBM option). Don't worry,
  109.                     the files are loaded correctly !
  110.                     
  111.  [ DELETE FILE ]    Delete the current Selected File from the Files List. If
  112.                     you pressed the wrong key...
  113.  
  114.  [ DIR <> LIST ]    Switch between the Directory and the Files List mode.
  115.  
  116.  
  117.  2.2 Directory / Files List window (right one)
  118.  -----------------------------------------------------------------------------
  119.  
  120.  The Status Line shows you in which mode you are (Directory or Files List),
  121.  the current entries number and the page number.
  122.  
  123.  
  124.  - PATH LINE           Show you the current path of the Workdisk (DF0).
  125.  
  126.  - DIRECTORY /         Show you 8 entries (current page) from the Directory
  127.    FILES LIST WINDOW   or the Files List.
  128.  
  129.  [ /\ Scroll Up ]      Get the previous page (previous 8 entries).
  130.  
  131.  [ \/ Scroll Down ]    Get the next page (next 8 entries).
  132.  
  133.  
  134.  DIRECTORY MODE :      - If you click a Directory (DIR): the path is changed
  135.                          and the next dir loaded...
  136.  
  137.                        - If you click a Filename: it appears in the Selected
  138.                          File Line. Then you can use the INSERT FILE command
  139.                          to insert it in the Files List.
  140.  
  141.  FILES LIST MODE :     - If you click a File: it appears in the Selected File
  142.                          Line. Then you can use the DELETE FILE command to
  143.                          delete it from the Files List.
  144.  
  145.                        - If you click a File, then a second one, their places
  146.                          will be exchanged. So you can make some order in the
  147.                          Files List (alphabetical order for example) before
  148.                          using the FILES IN BBM option.
  149.  
  150.  
  151.  2.3 Colors Palette window (3rd one)
  152.  -----------------------------------------------------------------------------
  153.  
  154.  With this palette you can change all the colors of the BootBlock-Menu. They
  155.  are (from left to right) :
  156.  
  157.  - 'Stripes'    : 2 stripes (up and down) for the CINEMASCOPE effect !
  158.  - Background 1 : 1st part of the background (before the underline)
  159.  - Underline    : line under the title
  160.  - Background 2 : 2nd part of the background (after the underline)
  161.  - Font colors  : 8 colors (from up to down) for the font
  162.  
  163.  Simply click the color you want to change and enter (in the Status Line) the
  164.  new color in HEX format (sorry...) : $xxx with x=0...9 a...f. Just try It !
  165.                                       / | \
  166.                                      /  |  \
  167.                                   Red Green Blue
  168.  
  169.  2.4 The BootBlock-Menu (lower part)
  170.  -----------------------------------------------------------------------------
  171.  
  172.  It shows you how your BootBlock-Menu will look like. Note that the real BBM
  173.  will use the TOPAZ 60 Font and that the lines are centered. The BBM texts
  174.  are :
  175.  
  176.  - The Title: 1 line of 48 chars (below the underline) for the name of your
  177.               pack.
  178.  
  179.  - The Menu: 10 lines of 58 chars (divided in 2 columns for 20 entries). Use
  180.              the FILES IN BBM command to put automagically the Files List in
  181.              your BBM. If you don't like this layout, you can type the texts
  182.              like you want, and if you use short filenames you can even put
  183.              more than 20 entries in the BBM ! It's up to you...
  184.  
  185.  
  186.  THE EDITOR : First, SORRY for this lame editor... But I coded everything by
  187.               myself (no system routines !) and I think this ed is good enough
  188.               for what you have to do !!! 
  189.               The supported keyboard is the USA one. This is a 'line-editor' :
  190.               to edit a text simply click the line at the position you want
  191.               and type in your text. You can press only one key at the same
  192.               time : if you want to use SHIFT or ALT, just press one of those
  193.               keys to activate the mode and then type. Repress one of those
  194.               keys to return to 'normal' typing. A little sprite (left) shows
  195.               you in which mode you are currently. You can also use :
  196.               
  197.               - CURSOR LEFT / CURSOR RIGHT to move the cursor
  198.               - BACKSPACE to go one char back and delete it
  199.               - SHIFT LEFT / SHIFT RIGHT to switch on/off the Shift mode
  200.               - ALT LEFT / ALT RIGHT to switch on/off the Alt mode
  201.               - RETURN / RIGHT MOUSE BUTTON to quit the edit mode
  202.  
  203.               Use the right mouse button to change the pointer and the cursor
  204.               color if you have some problem to see them because of the
  205.               background color...
  206.  
  207.  
  208.  3. Quick 'Step By Step' instructions
  209.  -----------------------------------------------------------------------------
  210.  
  211.  To create a new pack :
  212.  
  213.     1) Prepare your pack with all the needed files and load this nice utility.
  214.  
  215.     2) Put your pack (Workdisk) in DF0: (always !) and read the directory.
  216.  
  217.     3) Click a Filename you want in your pack, select the INSERT FILE command
  218.        and press the corresponding Key to load this file. Go on till your
  219.        Files List is ready. Then use the SAVE FILES command to save your Files
  220.        List to disk.
  221.  
  222.     4) Write the Loader to disk with the WRITE LOADER command. All the needed
  223.        files (Loader, Run, StartUp-Sequence...) are written ! You'll have to
  224.        add by yourself the other files you'll need (Add44k, Intro, Reset,...)
  225.        on the disk and in the startup-sequence.
  226.  
  227.     5) Prepare your BootBlock-Menu : use the FILES IN BBM option to put your
  228.        Files List in the BBM (make some order before...) or just type in all
  229.        the Filenames and Keys by yourself. Just like you want ! Change the
  230.        BBM Colors by using the Palette and when ready, save it to disk with
  231.        the WRITE BBM command. You can also read an old BBM because you like
  232.        its colors (use the READ BBM command)... If you have external drive(s)
  233.        then use them !
  234.  
  235.        Your pack is finished ! If you start another pack, don't forget to
  236.        clear the old Files List with the CLEAR FILES command. Then go to 1).
  237.  
  238.  
  239.  To update a pack (because you get a new version of a prg) :
  240.  
  241.     1) Put your pack (Workdisk) in DF0: and read the directory.
  242.  
  243.     2) Load the old Files List with the LOAD FILES command. Clear the old File
  244.        in the Files List with DELETE FILE, and insert the new one with INSERT
  245.        FILE. Save the Files List to disk when ready.
  246.  
  247.     3) Read the old BBM with the READ BBM command. Modify the Menu (texts and
  248.        colors...). Save the BBM to disk (DF0). 
  249.  
  250.        That's all !
  251.  
  252.  
  253.  4. Important remarks !!!
  254.  -----------------------------------------------------------------------------
  255.  
  256.  - The Workdisk (your pack) is ALWAYS in DF0:
  257.  - Don't use Filenames with 'spaces' and longer than 40 chars
  258.  - The maximal length of the Files List is 4096 bytes (should be enough !)
  259.  
  260.  Some technical infos :
  261.  -----------------------------------------------------------------------------
  262.  Boot-Menu Writer 1.0 works with Kickstart 1.2 and 1.3 on A500, A1000, A2000.
  263.  All the needed memory is in the code and it is 100% PC relative !!! So there
  264.  should be no problem with Fastmem... It support all external drives. I think
  265.  most of the bugs are removed ! (I hope...)
  266.  
  267.  Please note that this program is 100% in Assembler and that the only System
  268.  Routines are used for disk access !!! That was a hard work... :-)
  269.  
  270.  >>> If you find some bugs or if you have any suggestions then please contact:
  271.     
  272.                               PROT KILLER/ZENITH
  273.                                   Ch. Four 1
  274.                                 1053 CUGY / VD
  275.                                  Switzerland
  276.  
  277.  
  278.  5. The long awaited Personal Greetings Part !!!
  279.  -----------------------------------------------------------------------------
  280.  
  281.  - First a special thanks to my friend SAMIR/ZENITH for helping me to optimize
  282.    the BootBlock.
  283.  
  284.  - All the members of ZENITH
  285.  - SPIRIT of ANOREXIA and TRIAD of CLASSIC
  286.  - DON WOTAN of DIGITAL FORCE INTERNATIONAL
  287.  
  288.  - My friends on the Visinfo Chatter (MICS) who knows me as 'ALFred' :-)))
  289.    Chris (SCA) - Amicom - Nakamichi - Ursus - Druid - Pepe - Tendy & Pepsi
  290.    JaneC - Bobo - Cat - Agamemnon - Pooky - King Tiger - Odi - etc...
  291.  
  292.  - My friends on IRC who also knows me as 'ALFred' : Celebrandil - Pumpkin
  293.    Bilbo - Criminal - Top - Setarkos - Mr. Scary - Dr. Delete and the others
  294.  
  295.  -----------------------------------------------------------------------------
  296.  
  297.  >>> Watch out for our soon coming new productions !!!
  298.  
  299.                                                          DOCTOR PSI / ZENITH                                    
  300.  
  301.